home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / rtc.z / rtc
Encoding:
Text File  |  1998-10-30  |  4.5 KB  |  102 lines
  1. RTC(3I)                                                Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      __rrttcc, RRTTCC, IIRRTTCC, IIRRTTCC__RRAATTEE - Returns clock register contents
  6.  
  7. SSYYNNOOPPSSIISS
  8.      C/C++:
  9.  
  10.      ##iinncclluuddee <<iinnttrriinnssiiccss..hh>>
  11.      lloonngg __rrttcc ((vvooiidd));;
  12.  
  13.      Fortran:
  14.  
  15.      IINNTTRRIINNSSIICC RRTTCC
  16.      RRTTCC (())
  17.  
  18.      IINNTTRRIINNSSIICC IIRRTTCC
  19.      IIRRTTCC (())
  20.  
  21.      EEXXTTEERRNNAALL RRTTCC(())
  22.      RREEAALL((KKIINNDD==88)) _t_i_m_e
  23.      CCAALLLL RRTTCC((_t_i_m_e))
  24.  
  25.      EEXXTTEERRNNAALL IIRRTTCC(())
  26.      IINNTTEEGGEERR((KKIINNDD==88)) _i_t_i_m_e
  27.      CCAALLLL IIRRTTCC((_i_t_i_m_e))
  28.  
  29.      IINNTTEEGGEERR((KKIINNDD==88)) IIRRTTCC__RRAATTEE,, NNCCYYCCPPSSEECC
  30.      NNCCYYCCPPSSEECC == IIRRTTCC__RRAATTEE(())
  31.  
  32. IIMMPPLLEEMMEENNTTAATTIIOONN
  33.      C/C++:  UNICOS and UNICOS/mk systems
  34.  
  35.      Fortran:  UNICOS, UNICOS/mk, and IRIX systems
  36.  
  37. SSTTAANNDDAARRDDSS
  38.      C/C++:  Cray Research extension
  39.  
  40.      Fortran:  CF90 and MIPSpro 7 Fortran 90 compiler extension to Fortran
  41.      90
  42.  
  43. DDEESSCCRRIIPPTTIIOONN
  44.      The __rrttcc, RRTTCC, and IIRRTTCC intrinsic functions return a real-time clock
  45.      value.  The value is expressed as the number of _c_l_o_c_k _t_i_c_k_s.  The
  46.      IIRRTTCC__RRAATTEE function returns the clock rate of the IIRRTTCC and RRTTCC
  47.      functions.
  48.  
  49. CC//CC++++ NNOOTTEESS
  50.      Because __rrttcc is an intrinsic function, no externally visible library
  51.      function is available for it.  The compiler generates inline code to
  52.      produce the result.
  53.  
  54. FFOORRTTRRAANN NNOOTTEESS
  55.      The names of these intrinsics cannot be passed as arguments.
  56.  
  57.      When RRTTCC is called as a subroutine, it accepts the following argument:
  58.  
  59.      _t_i_m_e   The real-time clock value is returned as a RREEAALL((KKIINNDD==88)) value.
  60.  
  61.      When IIRRTTCC is called as a subroutine, it accepts the following
  62.      argument:
  63.  
  64.      _i_t_i_m_e  The real-time clock value is returned as an IINNTTEEGGEERR((KKIINNDD==88))
  65.             value.
  66.  
  67.      The RRTTCC intrinsic function is outmoded.  For information on outmoded
  68.      features and their preferred standard alternatives, see the _F_o_r_t_r_a_n
  69.      _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, _V_o_l_u_m_e _3, publication SR-3905.
  70.  
  71.      The use of RRTTCC is not recommended on UNICOS or IRIX systems.  See the
  72.      standard SSYYSSTTEEMM__CCLLOOCCKK(3I) intrinsic subroutine for the preferred
  73.      alternative.
  74.  
  75. FFOORRTTRRAANN RREETTUURRNN VVAALLUUEESS
  76.      RRTTCC returns a 64-bit real value.  IIRRTTCC returns a 64-bit integer value.
  77.  
  78.      When using CF90 on a UNICOS system, RRTTCC returns the low-order 46 bits
  79.      of the clock register as a RREEAALL((KKIINNDD==88)) value.  IIRRTTCC returns the
  80.      current content of the clock reg4i6ster as an INTEGER(KIND=8) value.
  81.      The result of IIRRTTCC may exceed 2  -1 and must not be used in
  82.      multiplication, division, or conversion to real unless the values is
  83.      typed as a 64-bit integer in the CF90 program or --ii 6644 is specified on
  84.      the ff9900(1) command line.  Addition and subtraction are unaffected.
  85.  
  86.      On IRIX systems, RRTTCC returns the low-order 52 bits of the system clock
  87.      expressed as a RREEAALL((KKIINNDD==88)) value.  IIRRTTCC returns the system clock as
  88.      an IINNTTEEGGEERR((KKIINNDD==88)) value.  IIRRTTCC__RRAATTEE returns the number of IIRRTTCC and
  89.      RRTTCC clock ticks per second in an IINNTTEEGGEERR((KKIINNDD==88)) value.  IIRRTTCC is the
  90.      fastest nonwrapping clock.
  91.  
  92. SSEEEE AALLSSOO
  93.      A complete list of C/C++ intrinsic functions available on Cray
  94.      Research systems is in the _C_r_a_y _C/_C++ _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR
  95.      -2179.
  96.  
  97.      ff9900(1), SSEECCOONNDD(3F), SSYYSSCCLLOOCCKK(3F), SSYYSSTTEEMM__CCLLOOCCKK(3I), TTSSEECCNNDD(3F)
  98.  
  99.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  100.      printed version of this man page.
  101.  
  102.